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METHOD, APPARATUS, MEDIA AND SIGNALS FOR SIMPLIFYING 

A PROGRAM LISTING 



BACKGROUND OF THE INVENTION 

5 

1 . Field of Invention 

This invention relates to text editors and more particularly to enhancements to text editors for 
simplifying a program listing. 

10 2 . Description of Related Art 

Program code written by programmers is becoming increasingly complex. Many text editors 
!^ provide for an organized listing of program code using separate lines for different functional 
H; statements, delimiters after functional statements, and indentation to identify portions of code of 
p a common context within the program. Different contexts of code portions in a program listing 

Ms 

15 ^ are often shown in a hierarchical fashion. 

U One problem with current technology in providing program listings is that all details of the 
q program listing are displayed. For particularly large and complex program listings, this can 
F " result in the display of a large quantity of unnecessary detail of the program, that is often 
20 irrelevant detail to analyses a programmer may be undertaking. Currently, the most common 
means of reducing complexity is to change the structure of the program, by decomposing the 
program into small units of work called procedures. This decomposition is not always feasible 
due to the interaction between variables and control blocks. What would be desirable is to have a 
reasonable way of reducing the amount of code displayed at one time on the screen. 

25 

SUMMARY OF THE INVENTION 

The present invention addresses the above need by providing a method and apparatus for 
simplifying a program listing involving receiving an identification of a portion of the program 
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listing to be hidden, receiving input indicating the portion is to be hidden, and causing a symbol 
to replace the portion of the program listing in response to the identification and the input 
indicating that the portion is to be hidden. In one embodiment, the above functionality can be 
provided by computer executable instructions for directing a processor circuit to carry out the 
5 above functions. Such instructions may be provided on a processor readable medium or through 

a communications interface, for example. 

Receiving the identification may involve receiving identifications of a start character position 
and an end character position identifying a beginning and ending respectively of the portion of 
10 ^. the program listing to be hidden. The method may further involve determining the start character 
position and the end character position. 

Determining the start character position and the end character position may involve identifying a 
CI portion of the program listing which is in a common context. This may be done by identifying a 
15 g context of a portion of the program listing at a cursor position, where the context identified is the 
f- ; common context. Identifying the context may involve locating a context start marker in 
f ; proximity to the cursor, determining a hierarchical level of the context start marker and locating a 
O context end marker for the context identified by the context start marker. 

20 The act of causing a symbol to replace the portion of the program listing which is to be hidden 

may involve associating that portion of the program listing which is to be hidden with the 
symbol. This may further involve associating the start character position and the end character 
position with the symbol. Associating may involve producing a hide record identifying the start 
character position and the end character position. 

25 

Causing the symbol to replace the portion of the program listing may involve showing the 
symbol instead of characters between the start character position and the end character position 
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of the program listing when the characters between the start character position and the end 
character position would otherwise be shown. 

Showing the symbol may involve loading an index to the symbol at a position in a display buffer 
which would normally be occupied by the portion to be hidden and loading into the display 
buffer after the index, a following portion of the program listing, which is to be shown. 

The method may further involve redisplaying at least one portion of the program which has been 
hidden. Alternatively, all hidden portions of the program listing may be redisplayed. This may 
be achieved by deleting one or all hide records identifying hidden portions of the program listing. 

In accordance with another aspect of the invention there is provided an apparatus for simplifying 
a program listing. The apparatus includes a processor circuit having an output device and a text 
editor for providing a representation of a program listing using the output device. The apparatus 
further includes provisions for receiving an identification of a portion of the program listing to be 
hidden, provisions for receiving input indicating that the portion is to be hidden and provisions 
for causing a symbol to replace the portion of the program listing in response to the identification 
and the input indicating the portion is to be hidden. 

In accordance with another aspect of the invention there is provided a computer readable medium 
for providing processor executable instructions for directing a processor circuit executing a text 
editor to receive an indication of a portion of a program listing provided by the text editor to be 
hidden, to receive input indicating the portion is to be hidden, and to cause a symbol to replace 
the portion of the program listing in response to the identification and the input indicating the 
portion is to be hidden. 

In accordance with another aspect of the invention, there is provided an apparatus for simplifying 
a program listing, where the apparatus includes the computer readable medium described above 
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and further includes a processor circuit having an output device for producing the program 
listing, and a text editor for causing the program listing to be displayed by the output device. The 
apparatus further includes an input device operable to receive the identification of the portion of 
the program listing to be hidden. 
5 In accordance with another aspect of the invention, there is provided a computer data signal 
having a first code segment for directing a processor circuit executing a text editor operable to 
provide a program listing, to receive an identification of a portion of the program listing which is 
to be hidden, a second code segment for directing the processor circuit to receive an input 
indicating the portion is to be hidden, and a third program portion for directing the processor 
10 O circuit to cause a symbol to replace the portion of the program listing in response to the 
■Jl identification and the input indicating the portion is to be hidden. 

jf In one sense the invention provides for hiding or collapsing a code block displayed by a code 
H editor, while preserving scope and coupling of the hidden code block and without making 
15 y 3 changes to the structure of the program. In other words it limits the information displayed to the 
*f programmer at any given time, to only the information selected by the programmer as being of 
St interest for display. 

Other aspects and features of the present invention will become apparent to those ordinarily 
20 skilled in the art upon review of the following description of specific embodiments of the 
invention in conjunction with the accompanying figures. 

BRIEF DESCRIPTION OF THE DRAWINGS 
In drawings which illustrate embodiments of the invention, 
25 Figure 1 is a block diagram of an apparatus according to a first embodiment of the 

invention; 

Figure 2 is a program listing having a portion which is desirable to be hidden; 
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Figure 3 



is a pictorial representation of a context sensitive menu provided by an 

enhancement, according to the first embodiment of the invention; 

is a flowchart of an automated selection routine provided by the enhancement; 

is a flowchart of a hide routine provided by the enhancement; 

is a flowchart of a display routine provided by the enhancement; 

is the program listing of Figure 2 with a symbol replacing a hidden portion of the 

program listing; 

is a flowchart of a restore routine provided by the enhancement; and 
is a flowchart of a restore all routine provided by the enhancement. 



Figure 4 
Figure 5 
Figure 6 
Figure 7 



Figure 8 
Figure 9 



DETAILED DESCRIPTION OF PREFERRED EMBODIMENTS OF THE INVENTION 

Referring to Figure 1, an apparatus according to a first preferred embodiment of the invention is 
shown generally at 10. In this embodiment, the apparatus includes a computer system having a 
processor circuit, which in this embodiment is provided by a central processing unit (CPU) 12 
that is coupled to a display 14, a keyboard 20, and a mouse 22. It will be appreciated that 
alternatively the processor circuit may be a micro-controller, or a distributed multiple processor 
system, for example. 

The CPU 12 has access to primary memory 16 and secondary memory 18. The primary memory 
16 may be realized as a number of different types of memory devices, including RAM devices, 
ROM devices, EPROM devices or EEPROM devices. The secondary memory 18 may be of any 
of a number of different secondary storage devices including a hard disk device, for example. 

The primary memory 16 holds a copy of an operating system 24 and a display buffer 25 for 
holding information to be displayed on the display 14. The primary memory 16 may also hold a 
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print buffer 27 for holding information to be printed by a printer 23 which may be controlled by 
the CPU 12. 



For purposes of discussion below, it will be assumed that the operating system 24 is the 
5 "MICROSOFT" WINDOWS 95 operating system from Microsoft Corporation of Redmond, 
Washington. 

In this embodiment, the primary memory 16 is further loaded with an application program which, 
in this embodiment includes an enhanced text editor 28 comprising a conventional text editor 30 
10 and an enhancement 32. The conventional text editor 30 may include a first set of instructions 
y3 for directing the CPU 12 to carry out the conventional functions of a text editor such as VISUAL 
£7 AGE7 by IBM, or Visual J++7 and/or VISUAL C++, both by Microsoft Corporation of 
2f Redmond, Washington, for example. The enhancement 32 includes a second set of instructions 
U which may be integrated into the enhanced text editor 28 or which may be provided as a separate 
15 |^ entity, with an interface to interact with the conventional text editor 30. 

^ Regardless of whether the enhancement 32 is provided separate or apart from the conventional 
U text editor 30, the effect of the enhancement when run by the CPU 12, is to provide for the 
simplification of a program listing such as may be provided on the display 14 or printed by the 

20 printer 23, so that a complex code listing produced by the conventional text editor 30 can be 
simplified to permit the user to get an overview of the complex code by eliminating details of the 
textual representations of specific blocks of code in particular portions of the listing. The 
enhancement 32 effectively directs the CPU 12 to receive an indication of a portion of the 
program listing to be hidden, in this embodiment, through user manipulation of the mouse 22 or 

25 keyboard 20, and to receive input from the user, through the mouse 22 or keyboard 20 indicating 
that the portion is to be hidden, and to cause a symbol to replace the portion of the program 
listing intended to be hidden, when the program listing is produced. In other words, the user can 
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select a particular portion of the listing to be hidden and when a program listing is produced, 
rather than displaying the portion intended to be hidden, a symbol is shown in its place. 
Similarly, different portions of the program listing can be selected to be hidden and each may be 
replaced with its own individual symbol or the same symbol, when a program listing is produced. 
In addition, the user can provide input to cause the CPU 12 to cause a previously hidden program 
portion to be redisplayed and conveniently, the user may select that all hidden portions be 
redisplayed, in which case the entire program listing is capable of being redisplayed in the 
conventional fashion. 

To achieve the above functionality, the enhancement 32 includes a hide segment 33 for providing 
hide functionality, a display segment 35 which interacts with the conventional text editor 30 to 
cause a conventional display routine thereof to display symbols instead of hidden text, a restore 
segment 37 which provides restore functionality, to cause the selected text to be redisplayed, and 
a restore all segment 39 which provides restore functionality so that all hidden text is redisplayed. 

Referring to Figure 1, with the CPU 12 running the conventional text editor 30 and the 
enhancement 32, a user will manipulate the mouse 22 or keyboard 20 to direct the conventional 
text editor 30 to display a program listing on the display 14, in the usual manner. Then, referring 
to Figures 1 and 2, also using the mouse 22 or keyboard 20, the user may position a cursor 41, 
produced by the operating system 24, on the display 14, at a location in the program listing 13 to 
identify a particular portion 43 of the listing which is to be hidden. In one embodiment, the user 
may select the portion 43 of the program listing 13 by using the usual selection function found 
with most conventional text editors. Once the portion 43 of the program listing 13 to be hidden 
has been identified or selected, the user may "right click" on the mouse 22 to call up a context 
sensitive menu such as shown at 40 in Figure 3, to enable the user to select from one of three 
functions, namely hide 45, restore 47 and restore all 49. Alternatively, these functions may be 
provided as buttons on a toolbar in a text editor window, for example. 
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On selection of the hide function 45, in this embodiment, the operating system 24 sends a 
message to the enhancement 32 identifying the function selected and identifying the beginning 
and end points and more particularly the beginning and ending character positions 51 and 53 
5 respectively of the portion 43 of the program listing 13 to be hidden, as identified by the 
beginning and ending of the selected portion of the listing. 

In an alternative embodiment, the hide function 45 may involve an automated selection routine 
15 such as shown in Figure 4 which may be provided by instructions within the hide segment 33 
10 q shown in Figure 1, for example. To use the automated selection routine 15 the user may simply 
% place the cursor 41 into a particular position on the program listing 13 shown in Figure 2 and 
then select the hide function 45 through the menu 40 as shown in Figure 3, whereupon the CPU 
Si 12 is directed to a first block of instructions shown at 42 in Figure 4 which cause it to parse 
p; through the program listing 13 shown in Figure 2 to identify a context of the portion 43 of the 
15 ^ program listing 13 nearest the cursor position. The context of the listing portion 43 refers to the 
0 hierarchical level of the function associated with the text of the identified portion. For example, 

%j a nested "DO" loop may be comprised of three nested loops, each at a different context level. 

fi 

J The text associated with a designated individual loop would be considered text within the same 
context as the designated individual loop. 

20 

To identify the context of the portion 43 of the program listing 13 in proximity to the cursor, the 
enhancement 32 makes use of the structure of the language in which the program identified by 
the program listing is written. Thus the rules for identifying context will vary from language to 
language. Once the context is determined, the beginning 51 and ending 53 character positions of 
25 the portion 43 of the common context are located as indicated by block 44 in Figure 4. 



CA9-2000-0075 



Page 8 of 20 



Each computer language written in a prose form imposes a syntactical structure on its elements. 
Some elements are contained within other elements forming a hierarchy. These hierarchies are 
useful for defining elements, control structures and limiting scope of identifiers. In one 
embodiment the closest inner context formed by such a hierarchy may be identified by finding 
5 the current position of the cursor. Next the text editor parses through the code in a computer 

language dependent manner. When the editor reaches the point in the code of the current position 
of the cursor that context is taken as the common context. 

Referring to Figures 1 and 5, regardless of how the start and end character positions 51 and 53 of 
10 _ the portion 43 of the program listing 13 which is intended to be hidden are identified, to carry out 
€j the process of hiding the identified portion of the listing, block 50 of the hide routine 17 directs 
m the CPU 12 to create a hide record in primary memory 16 and associate the hide record with the 
H program listing 13. The hide record may include fields for holding values representing the start 
p and end character positions 51 and 53 of the portion 43 of the program listing 13 intended to be 
15. hidden. 

^ In addition, block 52 directs the CPU 12 to associate a place holder or symbol with the identified 
y portion 43 to be hidden. This may involve providing an index to an icon image or text message, 

for example. The index may be stored in an index field of the hide record, for example. Block 
20 54 then directs the CPU 12 to refresh the display buffer 25 by causing it to execute a display 

routine 61 shown in Figure 6 provided by the display segment 35 shown in Figure 1. 

Referring to Figure 6, the display routine 61 includes a first block of instructions 62 which direct 
the CPU 12 to find the first hide record produced by the hide routine shown in Figure 5 if one 
25 exists. At block 64, if a hide record is found, then block 65 directs the CPU 12 to employ the 
normal display buffer filling routines associated with the conventional text editor 30 to cause the 
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program listing to be loaded into the display buffer 25, up to but not including the character 
position identified by the start character position 51. 

Then block 66 directs the CPU 12 to load the index to the associated symbol into the display 
5 buffer 25, beginning at the start character position 51 in the display buffer 25 that would 
normally be occupied by the first character of the portion to be hidden. 

Then, block 68 directs the CPU 12 to go to a position 55 in the program listing, immediately 

following the end character position 53 identified in the hide record and to resume filling the 
10 Q display buffer 25 from that position, or until a position in the program listing 13 corresponding to 

a start position of another hidden portion is located. The above process of blocks 66 and 68 is 
fj repeated until at block 69 the CPU 12 detects that the entire program listing has been parsed and 
SJ all identified hidden portions have been replaced with symbol indices in the display buffer 25. 
£1 Thus, effectively the display buffer 25 is filled with the program listing with the exception that 
15 ^ those portions of the program listing which are intended to be hidden are replaced with indices to 
13 symbols to indicate that a portion of the program listing is hidden. In the above manner, when 
%J conventional display buffer routines within the conventional text editor 30 are executed, the 

symbol 73 associated with the above-mentioned index is shown on the display 14, in place of the 

portion 43 of the program listing 13 intended to be hidden, as shown in the simplified program 
20 listing shown in Figure 7. In this embodiment, the symbol 73 is simply a text message 

comprising the word "hidden" in square brackets, but of course it could be an icon or any other 

indicator. 

To restore the display of the hidden portions of the program listing 13, the user must first place 
25 the cursor 41 in proximity to the symbol 73 identifying a hidden portion of the program listing on 
the display 14 such as shown in Figure 7. Then, the user may invoke the context sensitive menu 
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shown in Figure 3 and select the restore function 47 which invokes a restore routine 70 shown in 
Figure 8 provided by the restore segment 37. 

The functionality of the restore routine 70 is shown in Figure 8 and begins with a first block 72 
which directs the CPU 12 to find and delete from the primary memory 16 the hide record 
associated with the symbol proximate to the cursor 41. Block 74 then directs the CPU 12 to 
refresh the display buffer 25 which causes the display routine shown at 61 in Figure 6 to be rerun. 
It will be appreciated that since the hide record which previously existed is now eliminated, the 
display routine 61 fails to find the hide record associated with the portion 43 of the program 
listing 13 adjacent the cursor 41 and therefore when refilling the display buffer 25 under the 
control of the display routine 61, the portion of the program listing that was previously hidden is 
loaded into the display buffer 25, for display. After the conventional display buffer routines are 
executed by the conventional text editor 30, the displayed program listing 13 appears as shown in 
Figure 2. 

Referring back to Figure 3, if at any time during the display of the program listing 13 the user 
should invoke the context sensitive menu 40 and select the restore all function 49, a restore all 
routine 81 provided by the restore all segment 39 shown in Figure 1 is executed. Referring to 
Figure 9 the functionality of the restore all routine 81 begins with a first block 80 which directs 
the CPU 12 to find and delete all hide records associated with the program listing 13. Block 82 
then directs the CPU 12 to execute the display routine 61 shown in Figure 6 to refill the display 
buffer 25 such that the symbol indices are replaced with text of the program listing associated 
with those symbol indices and the remaining text of the program listing 13 is adjusted 
accordingly. In this way, the entire text of the program listing 13 is restored in the display buffer 
25 such that the entire program listing can be displayed by conventional routines. 
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It will be appreciated that processor readable instructions for providing the functionality provided 
by the enhanced text editor 28 are stored in the primary memory 16 for use by the CPU 12. The 
enhancement 32 may be conveyed to the primary memory 16 through a computer readable 
medium and read by a computer readable media reader 90 shown in Figure 1, which may include 
a CD- ROM7 reader, a DVD7 reader, a floppy disk drive or a tape drive, for example. An editor 
with the enhanced functionality provided by the enhancement 32, or the enhancement alone may 
be provided on any one of the above-mentioned types of media, as executable instructions stored 
on such media. Alternatively, the editor 28 with the enhancement 32 or the enhancement alone 
may be provided in a computer readable signal received at a communications interface 92 shown 
in Figure 1, the computer readable signal comprising at least a code segment for directing the 
CPU 12 to carry out the functionality of the enhancement 32, In this embodiment the 
communications interface 92 includes a modem to enable computer readable signals to be 
received from a network such as a public network, such as the internet, or alternatively, a radio 
frequency or wireless communications interface may be employed to receive such a computer 
readable signal in a carrier wave transmitted in a wireless system, for example. 

While specific embodiments of the invention have been described and illustrated, such 
embodiments should be considered illustrative of the invention only and not as limiting the 
invention as construed in accordance with the accompanying claims. 
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